Skip to content

fix: stop rendering skill.md by enumerating Quarto render globs#236

Merged
rich-iannone merged 1 commit into
posit-dev:mainfrom
has2k1:fix-skill-md-render-exclusion
Jun 28, 2026
Merged

fix: stop rendering skill.md by enumerating Quarto render globs#236
rich-iannone merged 1 commit into
posit-dev:mainfrom
has2k1:fix-skill-md-render-exclusion

Conversation

@has2k1

@has2k1 has2k1 commented Jun 26, 2026

Copy link
Copy Markdown
Collaborator

The PR addresses skill.md being rendered into the docs site despite the !skill.md exclusion in project.render, because a recursive ** glob overpowers any ! negation that follows it. For example, with render: ["**", "!skill.md"] Quarto still rendered skill.mdskill.html; a post-render step then deleted that stray skill.html, which crashed great-docs build --watch when Quarto's file monitor tried to hash the now-missing file (#228).

This PR seeds project.render with Quarto's default input globs

["*.qmd", "*.md", "*.markdown", "*.rmd", "*.Rmd", "*.rmarkdown", "*.ipynb"]

instead of **, so the !skill.md exclusion — and the analogous custom-page exclusions — actually take effect while still matching files recursively (subdirectory pages like user_guide/*.qmd continue to render).

With skill.md no longer rendered, it also removes the now-dead post-render workarounds that deleted skill.html and rewrote its links, so skill.md is served directly as a resource and the watch build no longer crashes.

fixes #228

A recursive "**" in project.render overpowers any "!" negation, so
Quarto rendered skill.md -> skill.html despite the !skill.md exclusion.
The stray skill.html was then deleted in post-render, which crashed
`build --watch` when Quarto tried to hash the missing file (posit-dev#228).

Seed project.render with Quarto's default input globs instead of "**" so
the !skill.md (and custom-page) exclusions take effect while still
matching files recursively. Remove the now-dead post-render workarounds
that deleted skill.html and rewrote its links.

fixes posit-dev#228
@rich-iannone rich-iannone self-requested a review June 26, 2026 19:29

@rich-iannone rich-iannone left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@rich-iannone rich-iannone merged commit 6643acd into posit-dev:main Jun 28, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

great-docs build --watch fails

2 participants